package com.cloud.picture.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.cloud.picture.model.dto.DeleteRequest;
import com.cloud.picture.model.dto.space.SpaceAddRequest;
import com.cloud.picture.model.dto.space.SpaceEditRequest;
import com.cloud.picture.model.dto.space.SpaceQueryRequest;
import com.cloud.picture.model.dto.space.SpaceUpdateRequest;
import com.cloud.picture.model.entity.Space;
import com.cloud.picture.model.entity.User;
import com.cloud.picture.model.vo.SpaceVO;

import javax.servlet.http.HttpServletRequest;

/**
* @author win
* @description 针对表【space(空间)】的数据库操作Service
* @createDate 2025-03-01 10:52:50
*/
public interface SpaceService extends IService<Space> {

    /**
     * 空间校验
     * @param space 空间
     * @param add true 创建 false 更新
     */
    void validSpace(Space space, boolean add);

    /**
     * 根据空间等级填充空间信息
     * @param space 空间
     */
    void fillSpaceBySpaceLevel(Space space);

    /**
     * 获取空间包装类
     * @param space 空间
     * @param request 请求
     * @return 空间包装类
     */
    SpaceVO getSpaceVO(Space space, HttpServletRequest request);

    /**
     * 获取空间分页包装类
     * @param spacePage 分页参数
     * @param request 请求
     * @return 空间分页包装类
     */
    Page<SpaceVO> getSpaceVoPage(Page<Space> spacePage, HttpServletRequest request);

    /**
     * 获取查询包装类
     * @param spaceQueryRequest 原始查询请求
     * @return 查询包装类
     */
    QueryWrapper<Space> getQueryWrapper(SpaceQueryRequest spaceQueryRequest);

    /**
     * 创建空间
     * @param spaceAddRequest 创建空间请求
     * @return 创建的空间id
     */
    Long addSpace(SpaceAddRequest spaceAddRequest, User loginUser);

    /**
     * 删除空间(仅管理员或空间创建人)
     * @param deleteRequest 删除请求
     * @return 是否成功
     */
    Boolean deleteSpace(DeleteRequest deleteRequest, HttpServletRequest request);

    /**
     * 更新空间(仅管理员)
     * @param spaceUpdateRequest 更新空间请求
     * @return 是否成功
     */
    Boolean updateSpace(SpaceUpdateRequest spaceUpdateRequest);

    /**
     * 编辑空间(仅空间创建人,不能编辑空间级别)
     * @param spaceEditRequest 编辑空间请求
     * @return 是否成功
     */
    Boolean editSpace(SpaceEditRequest spaceEditRequest);

    void checkSpaceAuth(User loginUser, Space space);
}
